Get Managed Endpoint

Route

/v2/endpoint-management/endpoints/{id}

Description

Retrieve details for a specific managed endpoint. Use DELETE to remove an endpoint record.

Methods

• GET — fetch endpoint details
• DELETE — remove an endpoint record

Inputs

Parameter	Type	Required	Description
id	string	Yes	Endpoint ID in the path

Output (GET)

Field	Type	Description
type	string	Always "endpoints"
size	integer	Number of endpoints returned (1)
resources	array[Endpoint]	Endpoint object
errors	array[Error]	Any errors

Endpoint Object (key fields)

Field	Type	Description
id	string	Endpoint identifier
hostname	string	Device hostname
machine_serial_number	string	Serial number
os	string	Operating system
os_version	string	OS version
sensor_version	string	Sensor version
profile	ProfileDetails	Assigned profile id/name
statuses_and_actions	array[StatusAndAction]	Health/status indicators
last_active_time	string	Last activity timestamp (ISO 8601)
deleted	boolean	Deleted flag

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response (GET)

{
  "type": "endpoints",
  "size": 1,
  "resources": [
    {
      "id": "endpoint-6fcd9b90-41f7-4ed6-a3a1-9fd6efb7c9aa",
      "hostname": "ACME-MAC-01",
      "os": "macos",
      "os_version": "14.0",
      "sensor_version": "24.03.90.366",
      "profile": {
        "profile_id": "profile-secure-laptops",
        "profile_name": "Secure Laptops"
      },
      "statuses_and_actions": [
        {"status": "healthy", "action": "none"}
      ],
      "last_active_time": "2024-01-15T10:30:00Z",
      "deleted": false
    }
  ],
  "errors": []
}